This file details the various external dependencies and configuration settings necessary to build ThunderGraft from its source and project/solution. In addition to the files in the ThunderGraft repository, ThunderGraft requires several external items.

DIRECTORY STRUCTURE

The ThunderGraft project and solution expect the following directory layout. Use of other layouts will require changing the ThunderGraft project and solution files appropriately.

+ Common [see below]
+ MPQDraft [the MPQDraft source directory; this is merely where the ThunderGraft binaries will be created by the linker, and ThunderGraft does not require that MPQDraft actually reside there]
+--- ThunderGraft [the ThunderGraft source directory from the ThunderGraft repository]

COMMON DIRECTORY

The Common directory acts as a sub-repository in the /common/ section of the MPQDraft repository (see http://sourceforge.net/projects/mpqdraft/) and is not duplicated in the ThunderGraft repository. If you are checking out the ThunderGraft source through Subversion or others, you will also need to check out the Common directory; however, the Common directory is included in the downloadable archives of ThunderGraft source.

Once downloaded, the Common directory must be added to the compiler include search path in the appropriate manner. For Visual Studio 2008, go to the Tools->Options... menu, select Projects and Solutions->VC++ Directories, then add it to the list for "Include files".

FMOD 4 SDK

The FMOD Ex 4 Software Development Kit must be downloaded and installed from the FMOD web site (http://www.fmod.org/). The include and library directories from the SDK must then be added to the compiler search path (for "Include files" and "Library files", respectively).

DIRECTSOUND HEADER

ThunderGraft requires the dsound.h header from the DirectX Software Development Kit. This kit is readily available from Microsoft's web site; however, as this header appears to function stand-alone, it might be sufficient to search for dsound.h on the web and download it by itself. In either case this file must be in the include search path, and if it is not automatically added by the SDK installer it must be added manually.

MICROSOFT FOUNDATION CLASSES / VISUAL C++ EXPRESS

For some reason the Visual Studio resource editor always generates resource (RC) files that depend on MFC header files, even when no MFC-specific features are used. This is a problem for Visual C++ Express users, as MFC is only supported for Visual Studio Standard and above. As the ThunderGraft resource file does not use any MFC-specific features, a workaround is to replace all instances of "afxres.h" with "windows.h" in the ThunderGraft.rc file. Alternately, you could attempt to find a copy of the MFC files online and download them, although they are not available in any official Microsoft download; in this case, the directory must be manually added to the include search path.